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The instnactlon vocabulary of MJICRO II can "be ©nriciied considerably 
through parameter asBignments and macro-instruction definitions* This 
memorandum is intended to help persons who are relatively new to TX-0 to 
acquaint themselves with some of its unusual properties (and peculiarities) o 
particialarly the m3croprogr€«nming feature. 

Many of the instructions discussed below are not currently defined 
in MACEO II • Howevere a tape containing most of thase sfefinitions is avail- 
able from the subroutine library as an English tape (£NG DDFS A) which may 
be copied into the beginning of the users" English tape. This set of 
definitions is also available as a binary symbol tape ^ BEFS A) which 
may be used to restore MCBO before making a conversion. The content of 
these tapes is given on the lest page of this memorandum. 

1. (foerate Instructions 

The following operate instructions not currently defined in KACRO II 
are frequently useful. Some of these operations are discussed below in more 
detail. 



Instruction 

anl = opr 305 
ana » opr 325 
orl = opr 105 
ora a opr 125 
Ice = lae+coin=opr 
amz a opr 51 
las a clc+lad-opr 
cry - opr 12 
lal = cla+cry«-opr 

ran » cyr9-cry»opr 
-p&n « opr 100 



Operation 

ACf^.ia-^Ea (Logical Product) 
&Qf\m -^m, 0-^AC ("AND" and Clear AC) 
AC (J LR -^ LR (Lo^cal Sum) 
ACUlR->La<, 04^AC ("OR" and Clear AC) 
•LR-^AC (Place complemssnt of IR in AC) 
(Add minus zero to AC) 
(LR minus zero in AC) 
( Carry see below) 
(Equivalent to lac 



AC + (-O)-HpAC 
LR + (-0)-<!'AC 
AC 5 m -^ AC 
LR + la "»AC 



followed by cyl) 

(Random Number Generator, see below) 

(Set AC Bits and 1 from light Pen 
Flip-Flops 1 and 2^ respectivelyo 
and clear Light Pen Flip-Flops,) 

In the TX«0 (and many other machines) „ addition is accomplished in two 
steps: partial add and carry «> These two operations are also separately useful 
as operate commands o 



lol Pcirtlal Add 

Thb partial sum of two numbers (x A y) la a number each of whose 
bits reprasents the "exclusive op" between corresponding bits of 2 and 
y* In terms of the Boolean functions "and" { f\ )^ "or" ( U ) and "not** 
( — )o then© 

2Ay«(xn-y)u (yA-z), (1) 
In particular <, it cfm be seen that 

X ^ Q m X (2) 

X ^2 « (3) 

X A -"O « -X (z^) 

Since this operation is associative^ it follows from (2) and (3) that 

X A y A y « X (5) 

The coamand lac (LR -^AC) mekea use of relation (2)o while 
Ice (-LR-> AC) uses {k)o Ipd (LR A AC ->AC) c&n be used to advantage 
in a number of waysc For example „ sui^ose that it is desired to 
combine bits ~ 8 of the AC and bits 9 - 18 of the LB into a single 
word (the unwanted portions of both resisters £0t assumed to be clear)- 
Making- use of (2) and (5)^ the desired result can be obtained in two 
steps: 

Ipd 

clr+lpd-opr 

lo2 Carry 

The carry operation is loosely analogous to the carry used in 
pencil -and-paper addition^ It may be defined as follows: 

A carry digit is a 1 if„ ir. the next less si^ificant bit^ 
either AC = and MBR = 1, or AC « 1 and th© carry digit = 1. 
The carry digits so determined are partial added to the ACo 

Let the result of a carry operation be denoted by AG & HBR s5nc« (in 
the one's coicplemant arithmetic of TX^-O) the addition operation is 
the result of the euccessive execution of partial add and carry « we 
may write 

X ■»• y « (x A y) ^ y (6) 

If v/e define 

« « X A y 
it follows froir. <5) that 

2Ay"xAyAy«x 

Hence (6) may b© written 

2 6 y « (2 A y) -f y (->) 



In particulfAro it nay be noted that 

fi y » (0 A y) •»■ y « 2yo (8) 

which gives rise to the lal command (LE + LR -^AC)^ and that 

».y £ y 3 (-y A y) + y « -0 -S- y^ (9) 

which ie represented by amz (-0 * AC -»AC)e 

The instruction cry (AC 6 LR-^AC) can be used in a number of 
ways. For exaapleo suppose thfct it la desired to sense v;hether bit 9 
of the LH contains a 1 or Oo This can t:e accomplished as follows: 

cla 

add (777377 

cry 

tm ha 

It can be seor tliat if bit 9 of the LH were Oo cry would not change 
the ACo BO control would be transferred to hao If bit 9 were 1^ hov- 
evera the entire AC would be complemented and the transfer voiad not 
be Qiadeo 

As a second exainpl©o suppose that it is desired to cycle left 
the contents of the IS treating the 12 least significant bits as a 
unit (i.SoB bypassing bits 0-5)0 This is accompli oh ed by 

cla 

add (770000 

cry 

llr (7777 

ana 

Following this set of operations „ the AC and bits - 5 of the LR will 
be clearo while bits 6-17 will be cycled left one position (the 
former bit 6 eoin^* to bit 17) o 

The instruction ran (« cyr-»xjry«opr)o when used with an appropriate 
number in the live regis ter^ can be used to produce a eeiiuence of psuedo» 
random numbarSo In particidaro the instructions 

cla 

add t 

llr (355670 

ran 

sto t 

can be used repeatedly to generate a sequence of appro xiujately 25O0OOO 
randoiri Ifi-bit words in register t (eventuiijlyo a previously computed 
value is obtained and the sequence repeats) c Plus zero is a good choice 
for the initial contents of to Minus zero should not be usedo 



To illustrate another application of pan^ suppose that it is 
desired to make a four-way branch (to locations bO through b3) depend- 

wn°" ' m' \^^ '"^ °^ '^' ^" ^-^"^ ^^^ ^^'"^ principxrthat was used 
before this is acconiplished by 

cla 

add {777377 
cry 

trn o44 
ran-fqom-opp 
tm bl 
tra bO 
pan 

trn b3 
tpa b2 ^ 

2« Kacro"ip8tructions 

*^ w- •e.^*®^f**^^°!^^^f instruction sequences occur often enough in irany pro^'rems 
to warrant their definition as macroso ** . 'J' ^ we:x«a» 

clad A 



llac A 



lice A 



move A„B 



load ArtC 



acst C»A 



step AoC 



cla 


add A 


llr A 


lac 


llr A 


Ice 


llr A 


sir £ 


llr (C? 


sir A 


add (0 


sto A 


cla 


add (C 


add A 


sto A 



t68t C»S 



can. s 



sul)r SpT 



add (-C 




trn S 




llr (tra 


0+2 


tra S 




llr (tpa 


T 


tra S 





2ol &ep«titlon« 

An aspect of profjrawming for the present confl^niretlon of TX-0 
that differs from many computers is the frequent need fop repetition 
of instructions (e.go in cycling and shifting)* For this purposso it 
is convenient to define a set of macros as followso 



define two P P P 
define three P two P P 
define four P three P P 



terminate 
terminate 
terminate 



etc e 

Then© for esampleo if the programmer wishes to cycle the AC nine places 
to the righto he can write 

nine cyr« 

In some cases o the programmer may wish to specify the number of 
repetitions at some later time by means of a parameter assignments For 
exampleo if he wishes to cycle left zip times (0^6. zip ^8)^ he may 
write 

loco eight cyl 

loc+zip! Kext instruction 



The binary tape will then store cyl in locations loc through loc+Sp 
then read in over this the following instructionso leaving cyl in 
locations loc through loc+zip-l-* 

If a large amount of shifting or cycling is reqjiiredo it is 
generally more efficient to use closed subroutines together v/ith macros, 
such as the following: 



Z2=< 



define 



shrc C 



llr (tra o+2 
tra 2Z+22-C 



terminate 



